DHTMLX Documentation

Migration to dhtmlxgrid 1.6

dhtmlxgrid 1.6 has some serious changes, which may cause problems with the previously written code.

Event System

        All direct event setting methods (setOnSome...), which were deprecated in the previous version of grid, are removed from the main code base. Now the only possible way to attach events is to use grid.attachEvent(...

        if you still need the old methods, you can include the following additional file in your project:
            ext/dhtmlxgrid_deprecated.js

        onMathEnd event is removed as in dhtmlxgrid 1.6 math values are calculated in sync mode, so they are available without delays.

Smart Rendering
- The following methods are deprecated:
  enableSmartRenderingSorting // is allowed by default
  enableDOMLimit

Paging
- In case of dynamical paging the grid uses the same vars, and awaits the same response as in case of dynamical smart rendering (basically you can use the same server side code to organize dynamical paging and dynamical smart rendering);
- The following methods were deprecated:
              enablePagingWT
              setPagingWTMode
              setPagingBlockParent
              setRecordsInfoParent
              enableRecordsInfo
              getNoRecordsString
              setNoRecordsString
              getRecordsInfoTemplate
              setRecordsInfoTemplatedc
              getPagePrefix
              setPagePrefix
- Since v.1.6 you can apply skin on paging. At the moment of version 1.6. release there are two skins (in addition to the default view) available: "bricks" (but it has 3 color schemas. Color schema is applied automatically based on the skin you've chosen for the grid itself) and "toolbar" (it uses dhtmlxToolbar to place paging controls). To apply paging skin use the following command:

mygrid.setPagingSkin("bricks");

Loading from CSV
- auto ID mode is enabled by default.

Global modes
- enableBuffering is deprecated (there is no sense in it anymore as the grid uses buffering automatically);
- findCell was moved to dhtmlxgrid_filter.js , it returns row IDs instead of row indexes (which are more reliable).

TreeGrid
- smartXMLParsing mode is enabled by default;
- if you are using "=sum" in treeGrid, you need to disable smartXMLParsing by mygrid.enableSmartXMLParsing(false).